home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Tampa Bay Amiga Group / TBAG - Tampa Bay Amiga Group's Disk of the Month #61 (1991)(Merlin's Software - Amiganuts United)(PD).zip / TBAG - Tampa Bay Amiga Group's Disk of the Month #61 (1991)(Merlin's Software - Amiganuts United)(PD).adf / Docs / BootPic.docs < prev    next >
Text File  |  1991-10-25  |  10KB  |  235 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV1.1                                 *
  4. *                                                                             *
  5. *                         © 1991 by Andreas Ackermann                         *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. CONTENTS:______________________________________________________________________
  10.  
  11.  
  12.        1. About shareware
  13.        2. Introduction
  14.        3. Installation
  15.        4. About the Parser
  16.        5. Kompatibility
  17.        6. What happens after resetting the machine ?
  18.        7. Possible sources of errors
  19.        8. About the programming
  20.  
  21. _______________________________________________________________________________
  22.  
  23. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  24. SHAREWARE-CONDITIONS:
  25.  
  26.     BootPic is SHAREWARE. You are allowed to copy BootPic as long as the
  27.     following conditions are kept :
  28.  
  29.     o  BootPic mustn't be changed
  30.     o  This DOC-file must be included
  31.     o  It mustn't be charged any fee (besides fees for copying or disks etc.)
  32.  
  33.     If you like BootPic and if you use it regularly or if you include parts of
  34.     the source in your own programms (e.g. the fading-routines) please feel free
  35.     to send me a small donation of 5$ or 5DM.
  36.  
  37.     If you want to use BootPic as part of a commercial programme, you need my
  38.     written permission.
  39.  
  40.     My Address:            Andreas Ackermann
  41.                            Lorenz-Summa-Str.10
  42.                            W-8679 Oberkotzau
  43.                            GERMANY
  44.                            Tel.:09286/6399
  45.  
  46. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  47. Please note:
  48. I wrote this software instead of doing a holiday job. If I'm able to earn some
  49. money in this way, other programmes and updates will follow (e.g. color-cycling,
  50. how about installing libraries resident [useful with arp.library] ?
  51.  
  52.  
  53.                                INTRODUCTION
  54.  
  55. Do you belong to the group of people who think the «Workbench-hand» that
  56. appears after every reset to be boring ?
  57. Then BootPic is the right thing for you. It allows you to load (nearly) any
  58. IFF-ILBM-picture instead of the «hand». (Overscan, HAM, Halfbright, etc.) It
  59. just has to be in compressed form. (e.g. DPaint saves its pictures in compressed
  60. form ).
  61. The installed programme uses 1K more memory than the length of the picture-file.
  62. [If there, it uses fast-memory]
  63.  
  64.                                INSTALLATION
  65.  
  66. BootPic can be started either from Workbench or CLI.
  67. If started from WB an intuition-style window with three gadgets will open :
  68.  
  69.  Load Picture : If you click on this gadget a window with a striggadget will
  70.                 open and asks you to enter a filename. If you press RETURN,
  71.                 BootPic will try to load this Picture, clicking on Cancel
  72.                 will stop any action. If you've got the ARP-Library installed,
  73.                 you'll get the ARP-Filerequester.
  74.                 If you selected BootPic together with another icon (see at
  75.                 example) you'll find its name already written in the string-
  76.                 gadget when opening the filerequester.
  77.  Remove Picture :
  78.                 Does nothing but that.
  79.  Info :         Displays an info-message.
  80.  
  81. The error-messages are exactly the same as described below.
  82.  
  83. The color used to fade to after displaying the picture is taken from the
  84. background color of the workbench screen at the moment it is being installed.
  85.  
  86. EXAMPLE:
  87. ­­­­­­­­   To install the picture that is included on this Disk, do the
  88.            following steps:
  89.            Open the BootPic-drawer. Click on the demo.pic icon. Then double-
  90.            click on the BootPic icon while holding the SHIFT-key.
  91.            Click on the Load Picture -gadget and press RETURN.
  92.            After resetting and removing any disks in df0: you can watch the
  93.            picture.
  94.  
  95.  
  96.  
  97. When started from CLI, BootPic is controlled by commandline parameters as usual.
  98. If no parameters are specified, a window as described above will open.
  99. The syntax is as follows :
  100.  
  101.                 BootPic -e | -l{IFF-File} [-s][-r][-c rgb]
  102.  
  103. -l{IFF-File}  Removes, if present, an old picture and then tries to install
  104.               a new one instead.
  105.  
  106.               Message if it had success:
  107.               «Picture successfully installed. Have Fun !»
  108.  
  109.               Possible faults:
  110.               «Couldn't open Picture-File»
  111.               «This is not an ILBM-Picturefile»
  112.               «Picture is not compressed»
  113.               «Warning:Couldn't find CAMG-Chunk»
  114.               CAMG-Chunk not found : The viewmodes are saved in this chunk
  115.               [e.g. Hires or Interlace etc.]. Until Kickstart 1.3 the picture
  116.               will be shown correctly despite of CAMG's missing.
  117.               [RESTRICTION: instead of Halfbright, HAM will be selected.]
  118.               «BODY-Chunk not found»
  119.               ILBM-File didn't contain image-data (should never happen).
  120.               «Memlist corrupt. Something went totally wrong»
  121.               Meaning see at -e
  122.               «Not enough Memory»
  123.  
  124. -e            Removes, if present, an old picture.
  125.  
  126.               Message if successful:
  127.               «Removed BootPic from List»
  128.  
  129.               Possible faults:
  130.               «BootPic not installed. Couldn't remove it»
  131.               «Memlist corrupt. Something went totally wrong»
  132.               BootPic discovered its memory, but it couldn't find its entry in
  133.               the resident table (should never happen).
  134.  
  135.               The following parameters work only together with -l :
  136.  
  137. -s            loads the file specified by -l only if BootPic is not yet
  138.               installed. In this way it is possible to use BootPic in the
  139.               Startup-Sequence.
  140.  
  141.               If BootPic was already installed it prints out :
  142.               «BootPic already installed. Changed nothing.»
  143.  
  144. -r            BootPic resets the machine after loading the picture.
  145.  
  146. -c            here you can specify the color which should be faded in after
  147.               showing the picture. Normally this is the background color of
  148.               your Workbench-Screen. The values of r,g and b must be specified
  149.               hexadecimal, so values from 0-9 and a-f are valid. [0 means that
  150.               this component isn't there at all and f means that it is there at
  151.               maximum idensity. (e.g. -c000 for black, -ce50 for orange).
  152.               Invalid values are accepted but the result will be other than
  153.               expected.
  154.               Default: 05a [Amiga-blue]
  155.  
  156.  
  157.  
  158.                                 ABOUT the PARSER
  159.  
  160.  All parameters may be specified either as small or capital letters. Every
  161.  parameter MUST start with «-», the order is at pleasure. Between the single
  162.  parmeters any number of spaces may be typed .
  163.  
  164.  Valid calls would be :
  165.  
  166.   bootpic  -l  :BootPic/demo.pic -R   -c  7aB
  167.  
  168.   bootpic -E
  169.  
  170.   bootpic -cAE3  -S -l:bootpic/demo.pic
  171.  
  172.  If -e or -l aren't specified, or if something else was typed wrong, BootPic
  173.  shows the usage.
  174.  If -e AND -l are specified, BootPic acts as if just -e was specified.
  175.  
  176.                                  KOMPATIBILTY
  177.  
  178.  BootPic installs itself in a «kindly» way, that means that any other resident
  179.  programme won't  be removed, e.g. Guardian, CARD:, but also viruses.
  180.  In the same careful way it removes itself.
  181.  
  182.                    What happens after RESETTING the machine  ?
  183.  
  184.  When BootPic was successfully installed, the loaded picture will be faded in
  185.  softly whenever there's no bootable disk in df0: .
  186.  When inserting a bootable disk the colors will be faded softly to the color
  187.  specified under -c and your system starts as usual .
  188.  [The fading of HAM-pictures looks a little bit curious but that's NO bug.]
  189.  If you press the left mouse button while the picture is shown, the usual
  190.  workbench-hand appears.
  191.  
  192.                          Possbile SOURCES of ERRORS
  193.  
  194.  Normally a picture that was once installed, stays in memory until you remove
  195.  it with -e [Remove Picture] or till you switch off your Amiga.
  196.  But there are some exceptions:
  197.  
  198.   a.)  If you play a game that believes all the memory belongs to itsself, it
  199.        is possible that the memory allocated by BootPic is overwritten.
  200.        Then you won't see the picture any more.
  201.   b.)  Many viruses simply overwrite the reset-vectors. In this case BootPic
  202.        will be gone, too.
  203.   c.)  Some virusdedectors (e.g. ATool) are of the opinion that every resident
  204.        programme is a virus, so BootPic will be removed, too.
  205.  
  206.  If one of these cases should arise, it may be possible, that you get a GURU
  207.  after a reset. If you can't remove it by clicking the left mousebutton,
  208.  switching off the Amiga is the only thing you can do.
  209.  
  210.                                 PROGRAMMING
  211.  
  212.  BootPic was written with the Devpac 2.14D - Assembler, that's the reason for
  213.  its small code size [less than 9K ].
  214.  Many thanks go to JM Forgeas for the wonderful editor AZ V1.50.
  215.  
  216.  The main programm still is exactly the the same as in V1.0, the only change
  217.  is, that V1.1 includes an intuition-interface. As the source doesn't contain
  218.  much new, I didn't include it this time. For those who just work in CLI and
  219.  who are interested in a small code size, I included once more V1.0, as it's
  220.  only half of the size.
  221.  
  222.  It's a pity that I only received two letters till today [19.7.1991].
  223.  The only positive thing about this is that noone seems to have found a bug.
  224.  
  225.  BootPic works well under Kickstart V1.2 and 1.3, but I wasn't able to test it
  226.  under Kickstart 2.0.
  227.  I am very thankful for critics, propositions and BUG-reports.
  228.  
  229.                          ENJOY !
  230.  
  231.   Oberkotzau, july 19th 1991                    Andreas Ackermann [*10.07.1974]
  232.   [ excuse my mistakes !!! ]
  233.  
  234.  
  235.